home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 4: GNU Archives / Linux Cubed Series 4 - GNU Archives.iso / gnu / git-4.3 / git-4 / git-4.3.11 / info / git.info-1 < prev    next >
Encoding:
GNU Info File  |  1996-06-06  |  49.4 KB  |  1,545 lines
  1. This is Info file git.info, produced by Makeinfo-1.63 from the input
  2. file ./git.texinfo.
  3.  
  4. START-INFO-DIR-ENTRY
  5. * GIT: (git).         GNU Interactive Tools
  6. END-INFO-DIR-ENTRY
  7.  
  8.    GIT: A set of interactive tools, by Tudor Hulubei and Andrei Pitis.
  9.  
  10.    This file documents the GNU Interactive Tools package.
  11.  
  12.    Copyright (C) 1993, 1994, 1995 Free Software Foundation, Inc.
  13.  
  14.    Permission is granted to make and distribute verbatim copies of this
  15. manual provided the copyright notice and this permission notice are
  16. preserved on all copies.
  17.  
  18.    Permission is granted to copy and distribute modified versions of
  19. this manual under the conditions for verbatim copying, provided that the
  20. entire resulting derived work is distributed under the terms of a
  21. permission notice identical to this one.
  22.  
  23.    Permission is granted to copy and distribute translations of this
  24. manual into another language, under the above conditions for modified
  25. versions, except that this permission notice may be stated in a
  26. translation approved by the Foundation.
  27.  
  28. 
  29. File: git.info,  Node: Top,  Next: Introduction,  Up: (dir)
  30.  
  31.    `GIT' is a package containing basically a file system browser, a
  32. process viewer/killer and a ASCII/HEX file viewer.  This is edition
  33. 2.2, for GNU Interactive Tools version 4.3.11.
  34.  
  35. * Menu:
  36.  
  37. * Introduction::        An introduction to GIT concepts.
  38. * Distrib::             How to get the latest GIT distribution.
  39.  
  40. * Key Index::           An item for each standard GIT key sequence.
  41. * Command Index::       An item for each command name.
  42. * Variable Index::      An item for each documented variable.
  43. * Concept Index::       An item for each concept.
  44.  
  45. * Description::         How to use GIT.
  46. * Customization::       How to customize GIT.
  47. * Limitations::         Known GIT limitations.
  48. * Bugs::                How to report a bug.
  49.  
  50. 
  51. File: git.info,  Node: Introduction,  Next: Distrib,  Prev: Top,  Up: Top
  52.  
  53. Introduction
  54. ************
  55.  
  56.    `GIT' is a set of interactive tools.  It contains an extensible file
  57. system browser, an ascii/hex file viewer, a process viewer/killer and
  58. some other related utilities and shell scripts.  It can be used to
  59. increase the speed and efficiency of most of the daily tasks such as
  60. copying and moving files and directories, invoking editors, compressing
  61. and uncompressing files, creating and expanding archives, compiling
  62. programs, sending mail, etc.  It looks nice, has colors (if the standard
  63. ANSI color sequences are supported) and is user-friendly.
  64.  
  65.    `GIT' runs on a wide variety of UNIX systems because it uses the
  66. `GNU Autoconf' package to get system specific information.  Please
  67. refer to the PLATFORMS file included in the standard distribution for a
  68. detailed list of systems on which `GIT' has been tested.
  69.  
  70.    One of the main advantages of `GIT' is its flexibility. It is not
  71. limited to a given set of commands.  The configuration file can be
  72. easily enhanced, allowing the user to add new commands or file
  73. operations, depending on its needs or preferences.
  74.  
  75.    `GIT' also provides a shell like command prompt, just to make sure
  76. that the entire power of the UNIX shell commands is still there.
  77.  
  78. 
  79. File: git.info,  Node: Distrib,  Next: Key Index,  Prev: Introduction,  Up: Top
  80.  
  81. Distributing GNU Interactive Tools
  82. **********************************
  83.  
  84.    `GIT' is "free software"; this means that everyone is free to use it
  85. and free to redistribute it on certain conditions.  `GIT' is not in the
  86. public domain; it is copyrighted and there are restrictions on its
  87. distribution, but these restrictions are designed to permit everything
  88. that a good cooperating citizen would want to do.  What is not allowed
  89. is to try to prevent others from further sharing any version of `GIT'
  90. that they might get from you.  The precise conditions are found in the
  91. GNU General Public License that comes with `GIT' and also appears
  92. following this section.
  93.  
  94.    The easiest way to get a copy of `GIT' is from someone else who has
  95. it.  You need not ask for our permission to do so, or tell any one else;
  96. just copy it.  If you have access to the Internet, you can get the
  97. latest distribution version of `GIT' from host `prep.ai.mit.edu' using
  98. anonymous login.  See the file `/pub/gnu/GETTING.GNU.SOFTWARE' on that
  99. host to find out about your options for copying and which files to use.
  100.  
  101.    You may also receive `GNU Interactive Tools' when you buy a
  102. computer.  Computer manufacturers are free to distribute copies on the
  103. same terms that apply to everyone else.  These terms require them to
  104. give you the full sources, including whatever changes they may have
  105. made, and to permit you to redistribute the GNU Interactive Tools
  106. received from them under the usual terms of the General Public License.
  107. In other words, the program must be free for you when you get it, not
  108. just free for the manufacturer.
  109.  
  110. 
  111. File: git.info,  Node: Description,  Next: Customization,  Prev: Concept Index,  Up: Top
  112.  
  113. Using GNU Interactive Tools
  114. ***************************
  115.  
  116.    The `GIT' package contains three interactive programs and a few
  117. additional utilities.  Here there is a description of each of them.
  118.  
  119. * Menu:
  120.  
  121. * git::                 A file system browser.
  122. * gitps::               A process viewer/killer.
  123. * gitview::             An ASCII/HEX file viewer.
  124. * gitcmp::              A file compare utility.
  125. * gitkeys::             An utility for displaying key sequences.
  126. * gitwipe::             An utility for wiping files.
  127. * gitmount::            A script for mounting file systems.
  128. * gitaction::           A per file type action script.
  129. * gitredir::            A internal stdout to stderr redirection script.
  130. * gitrgrep::            A recursive grep script.
  131.  
  132. 
  133. File: git.info,  Node: git,  Next: gitps,  Up: Description
  134.  
  135. The GIT file system browser
  136. ===========================
  137.  
  138.    `git' is a file system browser with some shell like features
  139. designed to make your work much easier and much efficient.  It displays
  140. one or two panels, each one containing a file system directory.  You can
  141. browse the directory tree with the usual cursor keys, pressing `ENTER'
  142. when you want to enter or leave a directory and `TAB' when you want to
  143. change the panels.
  144.  
  145.    Under the two panels there is a shell like input line which you can
  146. use to type normal shell commands.  The input line can handle an
  147. unlimited number of characters and keeps a history of typed commands
  148. (using the GNU history library).
  149.  
  150.    Under the input line there is a status bar.  You can see there the
  151. status of the currently executed command, the warnings and errors and
  152. you will be prompted if a decision has to be taken.
  153.  
  154. * Menu:
  155.  
  156. * Conventions::                 Key binding conventions.
  157.  
  158. * Modes::                       How panels can look like.
  159. * Sorting::                     How files can be sorted in a panel.
  160. * Moving::                      How to move the cursor in the panel.
  161. * Selecting::                   How to select (mark) files in a panel.
  162. * Isearch::                     How to search a file name in a panel.
  163. * Input Line::                  How to use the input line.  Basic editing.
  164. * Files::                       How to copy/move/delete/compress/... files.
  165. * Directories::                 How to operate with directories.
  166. * Compiling::                   How to compile programs.
  167. * Mail::                        How to send/receive ascii/binary mail.
  168. * Shell::                       How to start a sub-shell.
  169. * Grep::                        How to use grep/recursive grep.
  170. * Locking::                     How to lock your console.
  171. * Refreshing::                  How to refresh the screen contents.
  172. * Reseting::                    How to reset your terminal.
  173. * Mounting::                    How to mount/unmount a file system.
  174. * Sysinfo::                     How to get some useful system information.
  175. * Environment::                 How to look at the environment variables.
  176. * Processes::                   How to view/kill processes.
  177. * Sync::                        How to synchronize your file systems.
  178.  
  179. * Documentation::               How to read documentation.
  180.  
  181. * Exit::                        How to exit GNU Interactive Tools.
  182.  
  183. 
  184. File: git.info,  Node: Conventions,  Next: Modes,  Up: git
  185.  
  186. Key binding conventions
  187. -----------------------
  188.  
  189.    `git' now provides a new, easy to remember, scheme to bind commands
  190. on keys.  This is only a convention, if you define new key bindings you
  191. may, or may not follow it.
  192.  
  193.    All the file commands start with `^C'.  This prefix can be followed
  194. by some modifiers, in order to affect the default behavior of the given
  195. command.  These modifiers are `b' and `r'.
  196.  
  197.    `b' - this modifier specifies that the command will run in
  198. background:
  199.  
  200.              ^CM = CHMOD; chmod %s{New mode of %i: ,%m} %i;;;;y
  201.  
  202. defines a command that changes the current selected files mode in
  203. foreground, while
  204.  
  205.              ^CbM = B-CHMOD; chmod %s{New mode of %i: ,%m} %i&;;;;y
  206.  
  207. defines a background command that does the same thing.
  208.  
  209.    `r' - this modifier specifies that the command will be run
  210. recursively:
  211.  
  212.              ^CrM = R-CHMOD; chmod -R %s{New mode of %i: ,} %i;;;;y
  213.  
  214. defines a command that recursively changes the mode of the selected
  215. files.
  216.  
  217.    The `b' and `r' modifiers can be combined, the resulting command
  218. running recursively and in background:
  219.  
  220.              ^CbrM = B-R-CHMOD; chmod -R %s{New mode of %i: ,} %i&;;;;y
  221.  
  222.    You should also note that for some commands (like `gzip') there is
  223. no need for a non-recursive version.  Running `gzip' recursively on
  224. files is harmless.  If there is a directory between these files, `gzip'
  225. will recursively compress that directory, so you can use the same key
  226. binding for recursively and non-recursively compressing.  In fact, it
  227. is a matter of selecting files or directories.
  228.  
  229.    Unfortunately, we can't run `chmod' recursively trying to change the
  230. mode of all the files in a directory to 0644 because that directory
  231. might contain subdirectories and removing the execution permission from
  232. them is a bad idea.  So, in this case, we need separate commands.
  233.  
  234. 
  235. File: git.info,  Node: Modes,  Next: Sorting,  Prev: Conventions,  Up: git
  236.  
  237. Panel modes
  238. -----------
  239.  
  240.    `git' has three major modes of displaying the panels.  In the first
  241. (default) mode, two panels are displayed, each one using half of the
  242. screen.  In the second mode, only one panel uses the entire screen.  In
  243. the third mode, only the status bar and the input line are displayed,
  244. both panels being hidden.
  245.  
  246.    Briefly, a panel can use the entire screen or just half of it.  Even
  247. when a panel is hidden, it still exists.
  248.  
  249.    Users can switch between these three major modes as needed:
  250.  
  251. `^X 0'
  252.      Enlarges the other panel to use the entire screen.  It also changes the
  253.      minor mode to `Enable all'. The current panel will become
  254.      invisible (`enlarge-other-panel').
  255.  
  256. `^X 1'
  257.      Enlarges the current panel to use the entire screen.  It also changes
  258.      the minor mode to `Enable all'. The other panel will become
  259.      invisible (`enlarge-panel').
  260.  
  261. `^X 2'
  262.      Switches back to the two panel mode (`two-panel-mode').
  263.  
  264. `^O', `ESC o'
  265.      Switches to the tty mode (no panels on the screen) (`tty-mode').
  266.  
  267.    Basically a panel displays the files and directories in a directory.
  268. You can optionally specify some additional information about each entry
  269. (file, directory, ...) to be displayed (a minor mode).
  270.  
  271.    When using the full screen mode, all the minor modes here can be
  272. used.  In half screen mode, the `panel-enable-all' mode is not
  273. available.
  274.  
  275.    These are the panel minor modes:
  276.  
  277. `ESC d o'
  278.      Display the entry owner and group (`panel-enable-owner-group').
  279.  
  280. `ESC d d'
  281.      Display the entry date and time (`panel-enable-date-time').
  282.  
  283. `ESC d s'
  284.      Display the entry size (`panel-enable-size').
  285.  
  286. `ESC d m'
  287.      Display the entry mode (`panel-enable-mode').
  288.  
  289. `ESC d f'
  290.      Display the entry full name (`panel-enable-full-name').
  291.  
  292. `ESC d a'
  293.      Display the entire information about file (`panel-enable-all').
  294.      This mode is only available if the panel has been enlarged to use the
  295.      entire screen with `enlarge-panel' or `enlarge-other-panel'
  296.      (`panel-enable-all').
  297.  
  298.    There is also another way to change the panel minor modes:
  299.  
  300. `^]', `^[]'
  301.      Switches to the next panel minor mode (`panel-enable-next-mode').
  302.  
  303. 
  304. File: git.info,  Node: Sorting,  Next: Moving,  Prev: Modes,  Up: git
  305.  
  306. Sorting methods
  307. ---------------
  308.  
  309.    Entries in a panel can be sorted in different ways.  These are the
  310. available options:
  311.  
  312. `ESC s n'
  313.      Display the panel entries sorted by their names
  314.      (`panel-sort-by-name').
  315.  
  316. `ESC s e'
  317.      Display the panel entries sorted by their extensions
  318.      (`panel-sort-by-extension').
  319.  
  320. `ESC s s'
  321.      Display the panel entries sorted by their sizes
  322.      (`panel-sort-by-size').
  323.  
  324. `ESC s d'
  325.      Display the panel entries sorted by their `last modified' stamps
  326.      (`panel-sort-by-date').
  327.  
  328. `ESC s m'
  329.      Display the panel entries sorted by their modes
  330.      (`panel-sort-by-mode').
  331.  
  332. `ESC s o i'
  333.      Display the panel entries sorted by their owner ids
  334.      (`panel-sort-by-owner-id').
  335.  
  336. `ESC s g i'
  337.      Display the panel entries sorted by their group ids
  338.      (`panel-sort-by-group-id').
  339.  
  340. `ESC s o n'
  341.      Display the panel entries sorted by their owner names
  342.      (`panel-sort-by-owner-name').
  343.  
  344. `ESC s g n'
  345.      Display the panel entries sorted by their group names
  346.      (`panel-sort-by-group-name').
  347.  
  348.    There is also another way to change the sort method:
  349.  
  350. `ESC s u'
  351.      Switch to the next panel sort method (`panel-sort-next-method').
  352.  
  353. 
  354. File: git.info,  Node: Moving,  Next: Selecting,  Prev: Sorting,  Up: git
  355.  
  356. Moving the cursor in the panel
  357. ------------------------------
  358.  
  359.    Moving the cursor in the panel is very easy.  If your keyboard has
  360. arrows, use them.  If the arrow keys don't work (it might be due to a
  361. badly configured TERM environment variable), you can use the Emacs
  362. commands bindings as well.
  363.  
  364. `UP', `^P'
  365.      Move the cursor vertically up one entry (`previous-line').
  366.  
  367. `DOWN', `^N'
  368.      Move the cursor vertically down one entry (`next-line').
  369.  
  370. `HOME', `ESC <'
  371.      Move the cursor on the first entry in the panel
  372.      (`beginning-of-panel').
  373.  
  374. `END', `ESC >'
  375.      Move the cursor on the last entry in the panel (`end-of-panel').
  376.  
  377. `PGUP', `ESC v'
  378.      Move the cursor vertically down one page (`scroll-down').
  379.  
  380. `PGDOWN', `^V'
  381.      Move the cursor vertically down one page (`scroll-up').
  382.  
  383. `^X P'
  384.      In order to optimize the screen output, you can modify the scroll step
  385.      (`set-scroll-step').  This is the number of lines to try scrolling
  386.      a panel when the cursor moves out.  The `StartupScrollStep'
  387.      specifies the initial scroll step, but using `set-scroll-step' you
  388.      can dynamically change it.
  389.  
  390. `TAB', `^I', `^X o'
  391.      Move the cursor in the other panel (`other-panel').
  392.  
  393. `^X P'
  394.      Switch the two panels.  This command works even when `git' is not
  395.      in the `two panels' mode (`switch-panels').
  396.  
  397. 
  398. File: git.info,  Node: Selecting,  Next: Isearch,  Prev: Moving,  Up: git
  399.  
  400. Selecting files
  401. ---------------
  402.  
  403. `INS', `^T', `^X \', `^\'
  404.      Toggle the `selected' flag of the current file
  405.      (`select-file').
  406.  
  407. `^C s'
  408.      Select (marks) all the files matching a pattern
  409.      (`select-files-matching-pattern').  The user will be prompted for a
  410.      pattern to match against.
  411.  
  412. `^C u'
  413.      Unselect (unmarks) all the files matching a pattern
  414.      (`select-files-matching-pattern').  The user will be prompted for a
  415.      pattern to match against.
  416.  
  417. 
  418. File: git.info,  Node: Isearch,  Next: Input Line,  Prev: Selecting,  Up: git
  419.  
  420. Incremental searching files in a panel
  421. --------------------------------------
  422.  
  423.    Users sometime need to search a file in a panel, especially when the
  424. panel contains a big number of entries.  For that reason `git' provides
  425. an incremental search feature.  Using forward and backward incremental
  426. search, files can be very easy located.  Wrapped incremental search is
  427. also provided.
  428.  
  429. `^S', `^Xs'
  430.      Incremental search forward a file name in the current panel
  431.      (`isearch-forward').  Pressing `^S' or `^Xs' again will
  432.      force `git' to go to the next entry that matches the current
  433.      isearched string.  When the end of the panel is reached, the isearch is
  434.      restarted from its beginning.
  435.  
  436. `^R', `^Xr'
  437.      Incremental search backward a file name in the current panel
  438.      (`isearch-backward').  Pressing `^R' or `^Xr' again will
  439.      force `git' to go to the next entry that matches the current
  440.      isearched string.  When the beginning of the panel is reached, the
  441.      isearch is restarted from its end.
  442.  
  443. 
  444. File: git.info,  Node: Input Line,  Next: Files,  Prev: Isearch,  Up: git
  445.  
  446. Using the input line
  447. --------------------
  448.  
  449.    The input line is one of the main methods used by `git' to interact
  450. with the user.  All the answers the user should give in order to perform
  451. some operation and all the shell like commands are built using it.  So
  452. here is a description of all the basic editing operations that the
  453. `input line' provides.  They are very much inspired from `Emacs', so
  454. `Emacs' users should have no problem using them.
  455.  
  456. * Menu:
  457.  
  458. * Inserting Text::      Inserting text by simply typing it.
  459. * Moving Point::        How to move the cursor to the place where you
  460.                           want to change something.
  461. * Erasing::             Deleting and killing text.
  462. * Case Changes::        Case conversion of words.
  463. * History::             Reusing recent input line arguments.
  464. * Setting Mark::        Commands to set the mark.
  465. * Yanking::             Reinserting recently killed text.
  466.  
  467. 
  468. File: git.info,  Node: Inserting Text,  Next: Moving Point,  Up: Input Line
  469.  
  470. Inserting Text
  471. ..............
  472.  
  473.    Typing characters is the most usual way of inserting text into the
  474. input line.  Key sequences starting with printable ascii characters are
  475. not allowed in `git' so typing `a' for example results in inserting `a'
  476. at the current point position.  Of course, there are some other ways of
  477. inserting text into the command line and here there is a description of
  478. most of them.
  479.  
  480. `ESC RET'
  481.      Copy the current file name into the input line at the current point
  482.      position (`file-to-input-line').
  483.  
  484. `ESC ESC RET'
  485.      Copy the other panel path into the input line at the current point
  486.      position (`other-path-to-input-line').
  487.  
  488. `^X ^G'
  489.      Copy the names of all the selected files into the input line at the
  490.      current point position (`selected-files-to-input-line').
  491.  
  492. 
  493. File: git.info,  Node: Moving Point,  Next: Erasing,  Prev: Inserting Text,  Up: Input Line
  494.  
  495. Moving Point
  496. ............
  497.  
  498. `^B', `LEFT'
  499.      Move the point backward one character (`backward-char').
  500.  
  501. `^F', `RIGHT'
  502.      Move the point forward one character (`forward-char').
  503.  
  504. `ESC b'
  505.      Move the point one word backward (`backward-word').
  506.  
  507. `ESC f'
  508.      Move the point one word forward (`forward-word').
  509.  
  510. `^A'
  511.      Move the cursor at the beginning of the input line (`beginning-of-line').
  512.  
  513. `^E'
  514.      Move the cursor at the end of the input line (`end-of-line').
  515.  
  516. 
  517. File: git.info,  Node: Erasing,  Next: Case Changes,  Prev: Moving Point,  Up: Input Line
  518.  
  519. Deleting and killing text
  520. .........................
  521.  
  522. `DEL', `^D'
  523.      Delete the character under the cursor (`delete-char').
  524.  
  525. `^H', `BKSPC'
  526.      Delete the character before the cursor (`backward-delete-char').
  527.  
  528. `ESC BKSPC'
  529.      Delete backward one word (`backward-kill-word').
  530.  
  531. `ESC d'
  532.      Delete forward one word (`kill-word').
  533.  
  534. `ESC k'
  535.      Delete the entire line (`kill-line').
  536.  
  537. `^U'
  538.      Delete all the characters between the beginning of the input line and
  539.      the point (`kill-to-beginning-of-line').
  540.  
  541. `^K'
  542.      Delete all the characters between the point and the end of the input
  543.      line (`kill-to-end-of-line').
  544.  
  545. `ESC SPC'
  546.      Delete all the spaces around the point, leaving only one space
  547.      (`just-one-space').
  548.  
  549. `ESC \'
  550.      Delete all the spaces around the point
  551.      (`delete-horizontal-space').
  552.  
  553. `^W'
  554.      Save the region between the point and the mark into the kill "ring" and
  555.      then kills it (`kill-region').  Note that there is no real
  556.      kill-ring here.  The so-called kill-ring has only one entry.
  557.  
  558. `ESC w'
  559.      Save the region between the point and the mark without killing it
  560.      (`kill-ring-save').
  561.  
  562. 
  563. File: git.info,  Node: Case Changes,  Next: History,  Prev: Erasing,  Up: Input Line
  564.  
  565. Case conversion of words.
  566. .........................
  567.  
  568. `ESC l'
  569.      Convert the following word to lower case, moving over.
  570.      (`downcase-word').
  571.  
  572. `ESC u'
  573.      Convert the following word to upper case, moving over.
  574.      (`upcase-word').
  575.  
  576. `ESC c'
  577.      Capitalize the following word, moving over.
  578.      (`capitalize-word').
  579.  
  580. 
  581. File: git.info,  Node: History,  Next: Setting Mark,  Prev: Case Changes,  Up: Input Line
  582.  
  583. Reusing recent input line arguments
  584. ...................................
  585.  
  586.    A separate history is kept for both built-in and user-defined
  587. commands.  If you call a command that you have used before, you can
  588. re-edit a previously entered string in order to minimize the amount of
  589. characters needed to be typed for the new one.  There is no limit on
  590. the number of strings that can be kept in the history.
  591.  
  592. `ESC p'
  593.      Walk backward through the history of previously entered strings
  594.      (`previous-history-element').
  595.  
  596. `ESC n'
  597.      Walk forward through the history of previously entered strings
  598.      (`next-history-element').
  599.  
  600. 
  601. File: git.info,  Node: Setting Mark,  Next: Yanking,  Prev: History,  Up: Input Line
  602.  
  603. Commands to set the mark
  604. ........................
  605.  
  606. `^SPC'
  607.      Set the mark at the current point position (`set-mark').
  608.  
  609. `^X ^X'
  610.      Exchange the current point position with the mark one
  611.      (`exchange-point-and-mark').
  612.  
  613. 
  614. File: git.info,  Node: Yanking,  Prev: Setting Mark,  Up: Input Line
  615.  
  616. Reinserting recently killed text
  617. ................................
  618.  
  619. `^Y'
  620.      Reinsert a previously killed text at the current point position
  621.      (`yank').
  622.  
  623. 
  624. File: git.info,  Node: Files,  Next: Directories,  Prev: Input Line,  Up: git
  625.  
  626. File operations
  627. ---------------
  628.  
  629. * Menu:
  630.  
  631. * Copying Files::               How to copy files.
  632. * Moving Files::                How to move files.
  633. * Creating Files::              How to create new files.
  634. * Deleting Files::              How to delete files.
  635. * Linking Files::               How to create hard and symbolic links.
  636. * Renaming Files::              How to rename a file.
  637. * Inode::                       How to change a file inode mode, owner, group.
  638.  
  639. * Editing Files::               How to edit and create files.  Default editor.
  640. * Viewing Files::               How to view files.  Default viewer.
  641. * Compressing Files::           How to compress and decompress files.
  642. * Encoding Files::              How to uuencode/uudecode a file.
  643. * Encrypting Files::            How to encrypt/decrypt files with pgp.
  644. * Comparing Files::             How to compare two files.
  645. * Spelling Files::              How to spell a file.
  646. * Wiping Files::                How to wipe a file.
  647. * Searching Files::             How to search a file.
  648. * Archive Files::               How to manage tar based archive files.
  649.  
  650. * Actions::                     A different action for each file type.
  651.  
  652. 
  653. File: git.info,  Node: Copying Files,  Next: Moving Files,  Up: Files
  654.  
  655. Copying Files
  656. .............
  657.  
  658. `F5', `^C C'
  659.      Copy the currently selected files and directories to the user supplied
  660.      path (`copy').
  661.  
  662. `^C b C'
  663.      Copy the currently selected files and directories to the user supplied
  664.      path.  The operation is performed in background (`B-COPY').
  665.  
  666. 
  667. File: git.info,  Node: Moving Files,  Next: Creating Files,  Prev: Copying Files,  Up: Files
  668.  
  669. Moving Files
  670. ............
  671.  
  672. `F6', `^C T'
  673.      Move the currently selected files and directories to the user supplied
  674.      path (`move').
  675.  
  676. `^C b T'
  677.      Move the currently selected files and directories to the user supplied
  678.      path.  The operation is performed in background (`B-MOVE').
  679.  
  680. 
  681. File: git.info,  Node: Creating Files,  Next: Deleting Files,  Prev: Moving Files,  Up: Files
  682.  
  683. Creating Files
  684. ..............
  685.  
  686.    The easiest way to create a new file is to start an editor passing
  687. the file name as an argument.  Most editors will try to create the file
  688. if the file doesn't exist.  *Note Editing Files::, for more information.
  689.  
  690. 
  691. File: git.info,  Node: Deleting Files,  Next: Linking Files,  Prev: Creating Files,  Up: Files
  692.  
  693. Deleting Files
  694. ..............
  695.  
  696. `F8', `^C D'
  697.      Delete the currently selected files and directories (`delete').
  698.  
  699. `^C b D'
  700.      Delete the currently selected files and directories.  The operation is
  701.      performed in background (`B-DELETE').
  702.  
  703. 
  704. File: git.info,  Node: Linking Files,  Next: Renaming Files,  Prev: Deleting Files,  Up: Files
  705.  
  706. Linking Files
  707. .............
  708.  
  709. `^C H'
  710.      Create a hard link from the current files to a user supplied file
  711.      name (`LINK').
  712.  
  713. `^C b H'
  714.      Create a hard link from the current files to a user supplied file name
  715.      (`B-LINK').  The action is performed in background.
  716.  
  717. `^C S'
  718.      Create a symbolic link from the current files to a user supplied file
  719.      name (`SYMLINK').
  720.  
  721. `^C b S'
  722.      Create a symbolic link from the current files to a user supplied file
  723.      name (`B-SYMLINK').  The action is performed in background.
  724.  
  725. 
  726. File: git.info,  Node: Renaming Files,  Next: Inode,  Prev: Linking Files,  Up: Files
  727.  
  728. Renaming Files
  729. ..............
  730.  
  731. `^C R'
  732.      Rename the current file or directory with the user supplied name
  733.      (`RENAME').
  734.  
  735. `^C b R'
  736.      Rename the current file or directory with the user supplied name.  The
  737.      operation is performed in background (`B-RENAME').
  738.  
  739. 
  740. File: git.info,  Node: Inode,  Next: Editing Files,  Prev: Renaming Files,  Up: Files
  741.  
  742. Changing a file's inode mode, owner and group
  743. .............................................
  744.  
  745. `^C M'
  746.      Change the mode of the currently selected files inodes (`CHMOD').
  747.  
  748. `^C b M'
  749.      Change the mode of the currently selected files inodes.  The operation
  750.      is performed in background (`B-CHMOD').
  751.  
  752. `^C r M'
  753.      Recursively change the modes of the selected files inodes if one of
  754.      them is a directory (`R-CHMOD').
  755.  
  756. `^C b r M'
  757.      Recursively change the modes of the selected files inodes if one of
  758.      them is a directory.  The operation is performed in background
  759.      (`B-R-CHMOD').
  760.  
  761. `^C O'
  762.      Change the owner of the currently selected files inodes (`CHOWN').
  763.  
  764. `^C b O'
  765.      Change the owner of the currently selected files inodes.  The operation
  766.      is performed in background (`B-CHOWN').
  767.  
  768. `^C r O'
  769.      Recursively change the owners of the selected files inodes if one of
  770.      them is a directory (`R-CHOWN').
  771.  
  772. `^C b r O'
  773.      Recursively change the owners of the selected files inodes if one of
  774.      them is a directory.  The operation is performed in background
  775.      (`B-R-CHOWN').
  776.  
  777. `^C G'
  778.      Change the group of the currently selected files inodes (`CHGRP').
  779.  
  780. `^C b G'
  781.      Change the group of the currently selected files inodes.  The operation
  782.      is performed in background (`B-CHGRP').
  783.  
  784. `^C r G'
  785.      Recursively change the groups of the selected files inodes if one of
  786.      them is a directory (`R-CHGRP').
  787.  
  788. `^C b r G'
  789.      Recursively change the groups of the selected files inodes if one of
  790.      them is a directory.  The operation is performed in background
  791.      (`B-R-CHGRP').
  792.  
  793. 
  794. File: git.info,  Node: Editing Files,  Next: Viewing Files,  Prev: Inode,  Up: Files
  795.  
  796. Editing Files
  797. .............
  798.  
  799. `F4'
  800.      Call the default editor with the current file name as an argument
  801.      (`EDIT').
  802.  
  803. `^X e'
  804.      Call the default editor with the selected files names as arguments
  805.      (`MULTIPLE-EDIT').
  806.  
  807. `^X ^F'
  808.      Create a new file by calling the default editor with the user supplied
  809.      file name as an argument (`FILE-CREATE').
  810.  
  811. `^X 4 a'
  812.      Call the default editor in order to edit the `ChangeLog' file
  813.      (`CHANGE-LOG').
  814.  
  815.    The default editor can be specified using the EDITOR or GIT_EDITOR
  816. environment variables.  *Note Environment Variables::, for more
  817. information.
  818.  
  819. 
  820. File: git.info,  Node: Viewing Files,  Next: Compressing Files,  Prev: Editing Files,  Up: Files
  821.  
  822. Viewing Files
  823. .............
  824.  
  825. `F3', `^X h'
  826.      Call the default viewer (`gitview') with the current file name as
  827.      argument (`VIEW').
  828.  
  829. `^X v'
  830.      Call the default pager (`more') with the currently selected file
  831.      names as arguments (`MULTIPLE-VIEW').
  832.  
  833. 
  834. File: git.info,  Node: Compressing Files,  Next: Encoding Files,  Prev: Viewing Files,  Up: Files
  835.  
  836. Compressing Files
  837. .................
  838.  
  839. `^C z'
  840.      Compress the currently selected files and directories
  841.      (`COMPRESS').
  842.  
  843. `^C b z'
  844.      Compress the currently selected files and directories.  The operation
  845.      is performed in background (`B-COMPRESS').
  846.  
  847. `^C Z'
  848.      Uncompress the currently selected files and directories
  849.      (`UNCOMPRESS').
  850.  
  851. `^C b Z'
  852.      Uncompress the currently selected files and directories.  The
  853.      operation is performed in background (`B-UNCOMPRESS').
  854.  
  855. `^C f Z'
  856.      Uncompress the currently selected files and directories
  857.      (`F-UNCOMPRESS').  Force uncompression of links.
  858.  
  859. `^C b f Z'
  860.      Uncompress the currently selected files and directories.  Force
  861.      uncompression of links.  The operation is performed in background
  862.      (`BF-UNCOMPRESS').
  863.  
  864. 
  865. File: git.info,  Node: Encoding Files,  Next: Encrypting Files,  Prev: Compressing Files,  Up: Files
  866.  
  867. Encoding Files
  868. ..............
  869.  
  870. `^C e'
  871.      Encode the currently selected file (`UUENCODE').
  872.  
  873. `^C b e'
  874.      Encode the currently selected file.  The operation is performed in
  875.      background (`B-UUENCODE').
  876.  
  877. `^C E'
  878.      Decode the currently selected file (`UUDECODE').
  879.  
  880. `^C b E'
  881.      Decode the currently selected file.  The operation is performed in
  882.      background (`B-UUDECODE').
  883.  
  884. 
  885. File: git.info,  Node: Encrypting Files,  Next: Comparing Files,  Prev: Encoding Files,  Up: Files
  886.  
  887. Encrypting Files
  888. ................
  889.  
  890. `^C p'
  891.      Encrypt (using `pgp') the current file (`ENCRYPT').
  892.  
  893. `^C P'
  894.      Decrypt (using `pgp') the current file (`DECRYPT').
  895.  
  896. 
  897. File: git.info,  Node: Comparing Files,  Next: Spelling Files,  Prev: Encrypting Files,  Up: Files
  898.  
  899. Comparing Files
  900. ...............
  901.  
  902. `^C ='
  903.      Compare (using `diff') the current ASCII file with the other panel
  904.      current file (`DIFF').  If both entries are directories, a
  905.      recursive diff is performed.
  906.  
  907. `^C ESC ='
  908.      Compare (using `diff') the current ASCII file with its latest
  909.      backup.  The latest backup is the file having the same name and a '~' at
  910.      the end (`LAST-BACKUP-DIFF').
  911.  
  912. `^C B'
  913.      Compare the current file with the other panel current file.  A binary
  914.      comparison is performed (`BINARY-COMPARE').
  915.  
  916. 
  917. File: git.info,  Node: Spelling Files,  Next: Wiping Files,  Prev: Comparing Files,  Up: Files
  918.  
  919. Spelling Files
  920. ..............
  921.  
  922. `^X I'
  923.      Run the `ispell' command with the current file name as an
  924.      argument.
  925.  
  926. 
  927. File: git.info,  Node: Wiping Files,  Next: Searching Files,  Prev: Spelling Files,  Up: Files
  928.  
  929. Wiping Files
  930. ............
  931.  
  932. `^C W'
  933.      Call `gitwipe' to wipe the selected files.  Asks for confirmation
  934.      before actually wiping them in order to avoid errors (`WIPE').
  935.    *Note gitwipe::, for more information.
  936.  
  937. 
  938. File: git.info,  Node: Searching Files,  Next: Archive Files,  Prev: Wiping Files,  Up: Files
  939.  
  940. Searching Files
  941. ...............
  942.  
  943. `ESC %'
  944.      Searche files on the file system, starting from the current directory
  945.      (`FIND').
  946.  
  947. `ESC &'
  948.      Use 'locate' to search files on the file system, starting from the
  949.      current directory (`LOCATE').
  950.  
  951. `^X w'
  952.      Locate the binary, source, and manual page files for a command
  953.      (`WHEREIS').
  954.  
  955. `^X W'
  956.      Locate a command; display its pathname or alias (`WHICH').
  957.  
  958. 
  959. File: git.info,  Node: Archive Files,  Next: Actions,  Prev: Searching Files,  Up: Files
  960.  
  961. Managing tar based archive files
  962. ................................
  963.  
  964. `^C a'
  965.      Create a `tar' archive containing all the currently selected files
  966.      and directories (`TAR').
  967.  
  968. `^C b a'
  969.      Create a `tar' archive containing all the currently selected files
  970.      and directories.  The operation is performed in background
  971.      (`B-TAR').
  972.  
  973. `^C A'
  974.      Expand the `tar' archive pointed by the cursor into the current
  975.      directory (`UNTAR').
  976.  
  977. `^C b A'
  978.      Expand the `tar' archive pointed by the cursor into the current
  979.      directory.  The operation is performed in background (`B-UNTAR').
  980.  
  981. `^C x'
  982.      Create a compressed `tar' archive containing all the currently
  983.      selected files and directories (`TAR-COMPRESS').
  984.  
  985. `^C b x'
  986.      Create a compressed `tar' archive containing all the currently
  987.      selected files and directories.  The operation is performed in
  988.      background (`B-TAR-COMPRESS').
  989.  
  990. `^C X'
  991.      Expand the compressed `tar' archive pointed by the cursor into the
  992.      current directory (`UNCOMPRESS-UNTAR').
  993.  
  994. `^C b X'
  995.      Expand the compressed `tar' archive pointed by the cursor into the
  996.      current directory.  The operation is performed in background
  997.      (`B-UNCOMPRESS-UNTAR').
  998.  
  999. 
  1000. File: git.info,  Node: Actions,  Prev: Archive Files,  Up: Files
  1001.  
  1002. A different action for each file type
  1003. .....................................
  1004.  
  1005.    Many files on `UNIX' systems have one or more extensions specifying
  1006. their types.  For example, a file that ends in `.c' is a file
  1007. containing a `C' program, while a file ending in `.tar.gz' is a `tar'
  1008. archive compressed with the `gzip' utility.  Having a default action
  1009. for each file type, binded on the same key, seems to be a good idea
  1010. because you can use that key to obtain type specific information about
  1011. a file or to process it in some type specific way much easier.  The
  1012. `GIT' package contains a script called `gitaction' that is used to
  1013. detect the current file type and perform a type specific action.  *Note
  1014. gitaction::, for more information.
  1015.  
  1016. `F2', `^X a'
  1017.      Perform an action on the current file, depending on its type
  1018.      (`FILE-ACTION').
  1019.  
  1020. 
  1021. File: git.info,  Node: Directories,  Next: Compiling,  Prev: Files,  Up: git
  1022.  
  1023. Directory operations
  1024. --------------------
  1025.  
  1026. * Menu:
  1027.  
  1028. * Creating Dirs::               How to create new directories.
  1029. * Copying Dirs::                How to copy directories.
  1030. * Deleting Dirs::               How to delete directories.
  1031. * Moving Dirs::                 How to move directories.
  1032. * Renaming Dirs::               How to rename directories.
  1033. * Dirs Usage::                  Summarize directory usage.
  1034. * Changing Dirs::               How to go to a new directory.
  1035. * Dirs History::                How to use the directory history.
  1036. * Hot Keys::                    Hot keys for the most used directories.
  1037.  
  1038. 
  1039. File: git.info,  Node: Creating Dirs,  Next: Copying Dirs,  Up: Directories
  1040.  
  1041. Creating directories
  1042. ....................
  1043.  
  1044. `F7', `^X M'
  1045.      Create a new subdirectory in the current directory with the user
  1046.      supplied name (`make-directory').
  1047.  
  1048. 
  1049. File: git.info,  Node: Copying Dirs,  Next: Deleting Dirs,  Prev: Creating Dirs,  Up: Directories
  1050.  
  1051. Copying directories
  1052. ...................
  1053.  
  1054. `F5 (for directories)', `^C C (for directories)'
  1055.      Copy the currently selected files and directories to the user supplied
  1056.      path (`copy').
  1057.  
  1058. `^C b C (for directories)'
  1059.      Copy the currently selected files and directories to the user supplied
  1060.      path.  The operation is performed in background (`B-COPY').
  1061.  
  1062. 
  1063. File: git.info,  Node: Deleting Dirs,  Next: Moving Dirs,  Prev: Copying Dirs,  Up: Directories
  1064.  
  1065. Deleting directories
  1066. ....................
  1067.  
  1068. `F8 (for subdirectories)', `^C D (for subdirectories)'
  1069.      Delete the currently selected files and directories (`delete').
  1070.  
  1071. `^C b D (for directories)'
  1072.      Delete the currently selected files and directories.  The operation is
  1073.      performed in background (`B-DELETE').
  1074.  
  1075. 
  1076. File: git.info,  Node: Moving Dirs,  Next: Renaming Dirs,  Prev: Deleting Dirs,  Up: Directories
  1077.  
  1078. Moving directories
  1079. ..................
  1080.  
  1081. `F6 (for directories)', `^C T (for directories)'
  1082.      Move the currently selected files and directories to the user supplied
  1083.      path (`move').
  1084.  
  1085. `^C b T (for directories)'
  1086.      Move the currently selected files and directories to the user supplied
  1087.      path.  The operation is performed in background (`B-MOVE').
  1088.  
  1089. 
  1090. File: git.info,  Node: Renaming Dirs,  Next: Dirs Usage,  Prev: Moving Dirs,  Up: Directories
  1091.  
  1092. Renaming directories
  1093. ....................
  1094.  
  1095. `^C R (for directories)'
  1096.      Rename the current file or directory with the user supplied name
  1097.      (`RENAME').
  1098.  
  1099. `^C b R (for directories)'
  1100.      Rename the current file or directory with the user supplied name.  The
  1101.      operation is performed in background (`B-RENAME').
  1102.  
  1103. 
  1104. File: git.info,  Node: Dirs Usage,  Next: Changing Dirs,  Prev: Renaming Dirs,  Up: Directories
  1105.  
  1106. Summarize directory usage
  1107. .........................
  1108.  
  1109. `^C U'
  1110.      Display the output of the `du -s' command on the status line
  1111.      (`DIRECTORY-USAGE').
  1112.  
  1113. 
  1114. File: git.info,  Node: Changing Dirs,  Next: Dirs History,  Prev: Dirs Usage,  Up: Directories
  1115.  
  1116. Changing directories
  1117. ....................
  1118.  
  1119. `^X d', `^X ^D'
  1120.      Change the current working directory.  The user is asked for a new
  1121.      directory name and the new directory is added to the directory history
  1122.      (`change-directory').
  1123.    *Note Dirs History::, for more information.
  1124.  
  1125. `ESC a c'
  1126.      Change the current directory of the current panel to the directory of
  1127.      the other panel (`adapt-current-directory').
  1128.  
  1129. `ESC a o'
  1130.      Change the current directory of the other panel to the directory of the
  1131.      current panel (`adapt-other-directory').
  1132.  
  1133. 
  1134. File: git.info,  Node: Dirs History,  Next: Hot Keys,  Prev: Changing Dirs,  Up: Directories
  1135.  
  1136. Directory History
  1137. .................
  1138.  
  1139.    Users usually work on a limited set of subdirectories.  Providing a
  1140. fast method of switching between a number of intensively used
  1141. directories is a good idea and `git' has a set of builtin commands for
  1142. doing it.
  1143.  
  1144.    Usually new directories are added to the directory history when the
  1145. `change-directory' built-in command is used.  `git' also adds the
  1146. current directory to the history list when started, when the directory
  1147. history is reseted and when a command having a non empty `new-dir'
  1148. field successfully completes its execution.  *Note new-dir::, for more
  1149. information.
  1150.  
  1151. `^X ^N'
  1152.      Go to the next directory in the history (`next-directory').
  1153.  
  1154. `^X ^P'
  1155.      Go to the previous directory in the history
  1156.      (`previous-directory').
  1157.  
  1158. `^X ^R'
  1159.      Reset the entire directory history.  As explained above, the current
  1160.      directory becomes the only directory in the history
  1161.      (`reset-directory-history').
  1162.  
  1163. 
  1164. File: git.info,  Node: Hot Keys,  Prev: Dirs History,  Up: Directories
  1165.  
  1166. Hot Keys
  1167. ........
  1168.  
  1169.    `git' provides default key bindings for switching to a number of
  1170. important directories as "/", "..", "$HOME", etc.
  1171.  
  1172. `ESC /'
  1173.      Go to the `/' directory (`ROOT-DIR').
  1174.  
  1175. `ESC .'
  1176.      Go to the `..' directory (`UP-DIR').
  1177.  
  1178. `ESC h'
  1179.      Go to the `~' ($HOME) directory (`HOME-DIR').
  1180.  
  1181. `ESC i'
  1182.      Go to the `/usr/include' directory (`INCLUDE-DIR').
  1183.  
  1184. `ESC 1'
  1185.      Go to the `/mnt/fd0' directory (`FIRST-FLOPPY-DIR').
  1186.  
  1187. `ESC 2'
  1188.      Go to the `/mnt/fd1' directory (`SECOND-FLOPPY-DIR').
  1189.  
  1190. 
  1191. File: git.info,  Node: Compiling,  Next: Mail,  Prev: Directories,  Up: git
  1192.  
  1193. Compiling programs
  1194. ------------------
  1195.  
  1196. `F9', `^X m'
  1197.      Run the `make' command in the current directory.
  1198.  
  1199. `^X b m'
  1200.      Run the `make' command in background in the current directory.
  1201.    *Note gitaction::, for more information.
  1202.  
  1203. 
  1204. File: git.info,  Node: Mail,  Next: Shell,  Prev: Compiling,  Up: git
  1205.  
  1206. Sending/receiving ascii/binary mail
  1207. -----------------------------------
  1208.  
  1209. `^C 2 a'
  1210.      Send the current current ascii file by mail to an user supplied email
  1211.      address.
  1212.  
  1213. `^C b 2 a'
  1214.      The same as above, the only difference being that the command runs in
  1215.      background.
  1216.  
  1217. `^C 2 b'
  1218.      Send the current current binary file by mail to an user supplied email
  1219.      address.  The file is uuencoded first.
  1220.  
  1221. `^C b 2 b'
  1222.      The same as above, the only difference being that the command runs in
  1223.      background.
  1224.  
  1225. `ESC x r m'
  1226.      Run the `emacs -f rmail' command.  This will start the Emacs's
  1227.      `rmail' function so that you can read your mail.
  1228.  
  1229. 
  1230. File: git.info,  Node: Shell,  Next: Grep,  Prev: Mail,  Up: git
  1231.  
  1232. Starting a sub-shell
  1233. --------------------
  1234.  
  1235. `^X z'
  1236.      Call a sub-shell as specified by the $GIT_SHELL environment
  1237.      variable (`SUB-SHELL').
  1238.    *Note Environment Variables::, for more information.
  1239.  
  1240. 
  1241. File: git.info,  Node: Grep,  Next: Locking,  Prev: Shell,  Up: git
  1242.  
  1243. Using grep and recursive grep
  1244. -----------------------------
  1245.  
  1246. `^X g'
  1247.      Search using `grep' all the selected files for a given pattern
  1248.      (`GREP').
  1249.  
  1250. `^X g'
  1251.      Search recursively using `gitrgrep' all the user specified files
  1252.      and directories for a given pattern (`RECURSIVE-GREP').
  1253.    *Note gitrgrep::, for more information.
  1254.  
  1255. 
  1256. File: git.info,  Node: Locking,  Next: Refreshing,  Prev: Grep,  Up: git
  1257.  
  1258. Locking your console
  1259. --------------------
  1260.  
  1261.    Having a lock feature might be a good idea and, since not all the
  1262. UNIX systems provide one, `git' tries to get around the problem ...
  1263.  
  1264. `^X p'
  1265.      Prompt the user for a password and locks the console until the same
  1266.      password is reinserted (`lock').
  1267.  
  1268. 
  1269. File: git.info,  Node: Refreshing,  Next: Reseting,  Prev: Locking,  Up: git
  1270.  
  1271. Refreshing the screen contents
  1272. ------------------------------
  1273.  
  1274.    Sometimes your screen needs to be refreshed.  Just think about what
  1275. happens when somebody wants to talk with you and the talk daemon writes
  1276. something like this
  1277.  
  1278.      Message from Talk_Daemon@galei.cs.vu.nl at 12:15 ...
  1279.      talk: connection requested by andrei@galei.cs.vu.nl.
  1280.      talk: respond with:  talk andrei@galei.cs.vu.nl
  1281.  
  1282. on your screen.  And sometimes you might also want to re-read the
  1283. current directories.  `git' provides some built-in commands for
  1284. refreshing the screen contents.
  1285.  
  1286. `^L'
  1287.      Re-read the directories contents re-displaying them using
  1288.      optimizations. Only those parts of the screen that have changed are
  1289.      repainted (`refresh').
  1290.  
  1291. `^X l'
  1292.      Refresh the entire screen contents without using optimizations.  Useful
  1293.      when some "nice" program wrote something on the screen, because
  1294.      `git' has no way to detect this (`hard-refresh').
  1295.  
  1296. 
  1297. File: git.info,  Node: Reseting,  Next: Mounting,  Prev: Refreshing,  Up: git
  1298.  
  1299. Reseting your terminal
  1300. ----------------------
  1301.  
  1302. `^X ^L'
  1303.      Call `reset' in order to reset the terminal to its default
  1304.      settings (`TTY-RESET').
  1305.  
  1306. 
  1307. File: git.info,  Node: Mounting,  Next: Sysinfo,  Prev: Reseting,  Up: git
  1308.  
  1309. Mounting/unmounting file systems
  1310. --------------------------------
  1311.  
  1312.    People dealing with lots of files usually need to save/restore/copy
  1313. files from/to other file systems.  In order to be more efficient, `git'
  1314. provides a set of key bindings for mounting and unmounting file
  1315. systems.  *Note gitmount::, for more information.
  1316.  
  1317.    The default key bindings set has been designed to work under
  1318. `Linux', but it can be easily changed for other UNIX systems with
  1319. different device names.  Reading the configuration file `.gitrc.common'
  1320. should be enough.  *Note Hot Keys::, for more information.
  1321.  
  1322.    As a convention, the `/mnt' directory is used to store an empty
  1323. subdirectory for each mountable file system.  Each file system is
  1324. actually mounted in its counterpart `/mnt' subdirectory. Try to follow
  1325. this convention since the `gitmount' script is heavily based on it.
  1326. *Note Customization::, for more information.
  1327.  
  1328. `ESC m a'
  1329.      Call `mount'(1) in order to mount the first floppy
  1330.      (`/dev/fd0') in the `/mnt/fd0' directory (`MOUNT-A').
  1331.  
  1332. `ESC m b'
  1333.      Call `mount'(1) in order to mount the second floppy
  1334.      (`/dev/fd1') in the `/mnt/fd1' directory (`MOUNT-B').
  1335.  
  1336. `ESC m t'
  1337.      Call `mount'(1) in order to mount the file system corresponding to
  1338.      the currently pointed to subdirectory.  For example, if you are in the
  1339.      `/mnt' directory and the cursor is on the `fd0' subdirectory,
  1340.      the first floppy will be mounted (`MOUNT-THIS').
  1341.  
  1342. `ESC r a'
  1343.      Call `umount'(1) in order to remove (unmount) the first floppy
  1344.      (`/dev/fd0') (`UMOUNT-A').
  1345.  
  1346. `ESC r b'
  1347.      Call `umount'(1) in order to remove (unmount) the second floppy
  1348.      (`/dev/fd1') (`UMOUNT-B').
  1349.  
  1350. `ESC r t'
  1351.      Call `umount'(1) in order to remove (unmount) the file system
  1352.      mounted into the currently pointed to subdirectory
  1353.      (`UMOUNT-THIS'). For example, if the current directory is
  1354.      `/mnt' and the cursor points to the `fd1' subdirectory, the
  1355.      second floppy will be unmounted.
  1356.  
  1357. 
  1358. File: git.info,  Node: Sysinfo,  Next: Environment,  Prev: Mounting,  Up: git
  1359.  
  1360. Getting some useful system information
  1361. --------------------------------------
  1362.  
  1363. `^X T'
  1364.      Call `date'(1) in order to display the current time/date
  1365.      (`DATE').
  1366.  
  1367. `ESC S f'
  1368.      Call `finger'(1) in order to display information about local and
  1369.      remote users  (`FINGER').
  1370.  
  1371. `ESC S m'
  1372.      Call `mount'(1) in order to display a list of the currently
  1373.      mounted file systems (`MOUNTED-FILE-SYSTEMS').
  1374.  
  1375. `ESC S q'
  1376.      Call `quota'(1) in order to display a user file system disk quota
  1377.      and quota (`QUOTA').
  1378.  
  1379. `ESC S s'
  1380.      Call `df'(1) in order to get the status of the currently mounted
  1381.      file systems (`DISK-FREE-SPACE').
  1382.  
  1383. `ESC S u'
  1384.      Call `users'(1) in order to get the name of the currently logged in
  1385.      users (`USERS').
  1386.  
  1387. `ESC S v'
  1388.      Call `$GIT_VMSTAT'(1) in order to get the current virtual memory
  1389.      status.  This is very system dependent, `Linux' uses `free',
  1390.      other systems use `vmstat', so the $GIT_VMSTAT variable is
  1391.      used to deal with this (`VIRTUAL-MEMORY-STATUS').
  1392.    *Note Environment Variables::, for more information.
  1393.  
  1394. `ESC S w'
  1395.      Call `who'(1) in order to find out who is on the system
  1396.      (`WHO').
  1397.  
  1398. 
  1399. File: git.info,  Node: Environment,  Next: Processes,  Prev: Sysinfo,  Up: git
  1400.  
  1401. How to look at the environment variables
  1402. ----------------------------------------
  1403.  
  1404. `^X E'
  1405.      Call `env'(1) in order to display the current environment
  1406.      (`ENV').
  1407.  
  1408. 
  1409. File: git.info,  Node: Processes,  Next: Sync,  Prev: Environment,  Up: git
  1410.  
  1411. Viewing/killing processes
  1412. -------------------------
  1413.  
  1414.    There are at least two kinds of `ps'(1) utilities.  One that accepts
  1415. (more or less) combinations of the 'a', 'u', and 'x' flags and another
  1416. that accepts combinations of 'e', 'f' and 'l' flags.  Since is quite
  1417. difficult to test which one works fine on a given `UNIX' system, `git'
  1418. provides key bindings for both of them.  Anyway, if your `ps'(1) fails
  1419. to accept the predefined combinations, please take a look in its manual
  1420. and then modify the `.gitrc.TERM' file as needed.
  1421.  
  1422.    Since the number of possible combinations of flags in the `ps'
  1423. command line is quite big and *very* system dependent, there is no real
  1424. reason to display them all here.  We are only interested in giving you
  1425. a starting point in your search through the `.gitrc.TERM' file.
  1426.  
  1427.    Note also that you can display a list of processes using `ps'(1) or
  1428. browse through a list of them (killing as needed) using `gitps'.  As a
  1429. convention, we have used the same key sequence for a given set of
  1430. `ps'(1) flags for both `ps'(1) and `gitps', the only difference being
  1431. that `ps'(1) keys end in an uppercase letter.  *Note gitps::, for more
  1432. information.
  1433.  
  1434.    Under Linux it is possible to see a tree of processes using
  1435. `pstree'(1).
  1436.  
  1437.    Here there are the default key bindings for the 'e', 'f' and 'l'
  1438. `ps'(1) flags combinations:
  1439.  
  1440. `ESC P b', `ESC P c', `ESC P e'
  1441.      Call `gitps' or `ps'(1) in order to browse through or display
  1442.      a list of currently running processes (`GITPS', `PS').
  1443.  
  1444. ... and the default key bindings for the 'a', 'u' and 'x' `ps'(1) flags
  1445. combinations:
  1446.  
  1447. `ESC P a', `ESC P l', `ESC P u' `ESC P x', `ESC P y'
  1448.      Call `gitps' or `ps'(1) in order to browse through or display
  1449.      a list of currently running processes (`GITPS', `PS').
  1450.  
  1451. `ESC P T'
  1452.      Call `pstree'(1) in order to displat the tree of currently running
  1453.      processes (`PSTREE').
  1454.  
  1455. `^X k'
  1456.      Call `kill'(1) in order to kill a user specified process with a
  1457.      given signal (`KILL').
  1458.  
  1459. 
  1460. File: git.info,  Node: Sync,  Next: Documentation,  Prev: Processes,  Up: git
  1461.  
  1462. Synchronizing the file systems
  1463. ------------------------------
  1464.  
  1465. `^X S'
  1466.      Call `sync'(1) in order to synchronize all the file systems
  1467.      (`SYNC').
  1468.  
  1469. 
  1470. File: git.info,  Node: Documentation,  Next: Exit,  Prev: Sync,  Up: git
  1471.  
  1472. Reading documentation
  1473. ---------------------
  1474.  
  1475. `^X q'
  1476.      Read a manual page. The user is prompted for its name (`MAN').
  1477.  
  1478. `F1, ^X i'
  1479.      Read an info documentation. The user is prompted for the documentation
  1480.      name (`INFO').
  1481.  
  1482. 
  1483. File: git.info,  Node: Exit,  Prev: Documentation,  Up: git
  1484.  
  1485. Exiting GNU Interactive Tools
  1486. -----------------------------
  1487.  
  1488. `F10', `^X ^C', `^X c'
  1489.      Exit GNU Interactive Tools (`exit').
  1490.  
  1491. 
  1492. File: git.info,  Node: gitps,  Next: gitview,  Prev: git,  Up: Description
  1493.  
  1494. The GIT process viewer/killer
  1495. =============================
  1496.  
  1497.    `gitps' is an interactive process viewer/killer.  It calls
  1498. internally the `ps'(1) utility so that's the reason why `gitps'
  1499. parameters are in fact `ps'(1) ones.
  1500.  
  1501.    Running `gitps' it is self explanatory.  Use the `arrows', `PageUp',
  1502. `PageDown', `Home', `End', `^N', `^P', `^V', `ESC v' to move in the
  1503. list, `^L' to refresh it and `F10' or `^G' to leave.
  1504.  
  1505.    You can change these keys, just read the GITPS-Setup, GITPS-Color,
  1506. GITPS-Monochrome and GITPS-Keys sections in the configuration files
  1507. `.gitrc.TERM'.
  1508.  
  1509. 
  1510. File: git.info,  Node: gitview,  Next: gitcmp,  Prev: gitps,  Up: Description
  1511.  
  1512. The GIT ASCII/HEX file viewer
  1513. =============================
  1514.  
  1515.    `gitview' is an ASCII/HEX file viewer.  Use the `arrows', `PageUp',
  1516. `PageDown', `Home', `End', `^N', `^P', `^V', `ESC v' to move in the
  1517. file, `^L' to refresh the screen and `F10' or `^G' to leave.
  1518.  
  1519.    You can change these keys, just read the GITVIEW-Setup,
  1520. GITVIEW-Color, GITVIEW-Monochrome and GITVIEW-Keys sections in the
  1521. configuration files `.gitrc.TERM'.
  1522.  
  1523. 
  1524. File: git.info,  Node: gitcmp,  Next: gitkeys,  Prev: gitview,  Up: Description
  1525.  
  1526. The GIT internal file compare utility
  1527. =====================================
  1528.  
  1529.    `gitcmp' is a file compare utility.  It outputs to stderr, `git'
  1530. catching its error messages this way.
  1531.  
  1532.    `gitcmp' has been designed to be used in `.gitrc.TERM' (`git''s
  1533. configuration file) and should not be used as a stand alone program.
  1534.  
  1535. 
  1536. File: git.info,  Node: gitkeys,  Next: gitwipe,  Prev: gitcmp,  Up: Description
  1537.  
  1538. The GIT key sequences display utility
  1539. =====================================
  1540.  
  1541.    `gitkeys' is a program that displays the key sequence sent by the
  1542. pressed key.  This is the key sequence received by `GIT' tools, so this
  1543. program is useful when setting up the `.gitrc.TERM' configuration files.
  1544.  
  1545.